home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / accs / watch_it / watch_it.txt < prev   
Encoding:
Text File  |  1992-08-20  |  9.9 KB  |  231 lines
  1. WATCH-IT - Picture Viewer for Atari ST/STE/TT/Falcon030     Version 1.0a
  2. -----------------------------------------------------------------------------
  3.  
  4. Author : Stefan Bock
  5. email  : sbock@informatik.uni-kl.de
  6.  
  7. WATCH-IT is Freeware. That means that you may feel free to give copies to
  8. your friends (and enemies), as long as:
  9. - you do not change the program or this text
  10. - you always copy both program and text
  11. - you do not copy it for commercial purposes (that includes PD-libraries,too) 
  12.  
  13. All rights are reserved by the author.
  14.  
  15.  
  16. 1. What is it ?
  17. ----------------
  18.  
  19. WATCH-IT is a picture viewer for Atari ST/STE/TT/Falcon030 computers.
  20. It was planned as a viewer for the new Falcon computer only, supporting
  21. the 256-colour-resolution and the truecolour-resolution, but as it is a plain
  22. GEM-program, you can also start it on the "old" Ataris as well.
  23. WATCH-IT runs on all memory-configurations, but 512 KByte may be too small
  24. for big pictures.  
  25.  
  26.  
  27. 2. How to start it 
  28. -------------------
  29.  
  30. There are three ways to run the program:
  31.  
  32.   i) application : if you start WATCH-IT as an application, a file selector 
  33.                    will appear. Choose a picture file here (at the moment,
  34.                    only GIF is supported, others will follow soon).
  35.                    Once the file is loaded, depacked and transformed into a
  36.                    bitmap, it will be displayed in a window.
  37.  ii) commandline : starting the program from a shell or from the desktop with
  38.                    one or more filenames as arguments will load all specified
  39.                    files as long as
  40.                    - there are AES-windows left,
  41.                    - there is enough memory left and
  42.                    - the internal limit of 32 windows is not exceeded.
  43.                    WATCH-IT uses ARGV for extended commandlines.
  44. iii) accessory   : clicking on the menu entry will give you the file-selector
  45.                    where you can choose a picture (see i) ).
  46.  
  47.  
  48. 3. How to operate it
  49. ---------------------
  50.  
  51. - You can move and size the window as usual and scroll the picture with the
  52.   sliders if it is bigger than the window.
  53.   If you move the mouse over the window and the picture can be scrolled, the
  54.   arrow will change into a sort of cross-cursor which indicates the
  55.   directions the picture can be scrolled to (play around with this, it's easy).
  56.   Now press and hold the left mouse-button. The picture can be scrolled by
  57.   moving the mouse until the left button is released again.
  58.  
  59. - Cursor keys scroll the picture, too, and SHIFT+<cursor key> scrolls a page
  60.   at a time.
  61.  
  62. - A double-click on the picture or pressing <CONTROL>-I or <TAB> gives you
  63.   an information-window:
  64.   Here you find the width, height and palette size of the picture, the time
  65.   it took WATCH-IT to process the picture (including loading-time) and the
  66.   amount of RAM it uses.
  67.   Note that WATCH-IT uses some bufferspace during depacking and dithering,
  68.   so this displayed amount is smaller than the memory you need to process
  69.   the picture.
  70.   You will also find four buttons labeled "Greyscale", "Colour", "No dither"
  71.   and "FS-Dither". These are not selectable in this release, sorry, but
  72.   definitely will be in the next version, so you can choose your favourite
  73.   display-mode here. At the moment, a default mode is choosen depending on
  74.   the resolution (see below).
  75.                 
  76. - Pressing HELP reveals a help window.
  77.   Click on "OK" or press <RETURN> to close this window.
  78.  
  79. - Click on "LOAD" in the info/help-window or press <CONTROL>-O to load 
  80.   another picture. In accessory-mode clicking on the menu-entry has the same
  81.   effect.
  82.  
  83. - Press <CONTROL>-W to cycle through all open windows.
  84.  
  85. - Press <CONTROL>-U to close the actual window or
  86.         <CONTROL>-Q to close all windows (when the program has been started
  87.                                           as an application, this means "Quit") 
  88.  
  89.  
  90. 4. The picture format(s)
  91. ------------------------
  92.  
  93. At the moment this is only GIF format, but others will follow.
  94. If you have suggestions about what formats should be supported, please contact
  95. the author (format descriptions are welcome, too).
  96.  
  97. GIF-formats 87a and 89a can be loaded, even though WATCH-IT only inter-
  98. pretes the main picture data. I never came across a GIF-file with more
  99. than one picture in it, but if you have such pictures which you cannot
  100. display properly with WATCH-IT, tell me, perhaps i can change it.
  101.  
  102.       "The Graphics Interchange Format(c) is the Copyright property of
  103.       CompuServe Incorporated. GIF(sm) is a Service Mark property of
  104.       CompuServe Incorporated."
  105.  
  106.  
  107. 5. The display modes
  108. ---------------------
  109.  
  110. As mentioned earlier, WATCH-IT was written for the "Falcon resolutions",
  111. and pictures will definitely look best in these resolutions. Nevertheless
  112. I included dither-algorithms for monochrome and 16-colour-modes, too.
  113. Some more dither algorithms and greyscale modes are already finished, but
  114. didn't make it into this first release version, sorry.
  115. Note that pictures have to be processed in device-independant format and
  116. then transformed into the device-dependant format, this will take a little
  117. bit more time than writing the data directly into screen-memory, but is
  118. unavoidable in a GEM-program. On the other hand WATCH-IT will (at least it
  119. should :-)) run on all resolutions. If WATCH-IT does not run on your graphic-
  120. card, please let me know.
  121.  
  122.   i) Truecolour-mode:
  123.      This mode has only been tested on the Falcons truecolour-mode. It should
  124.      run on all resolutions with a device-independant format containing 16
  125.      planes, but i have no information about how RGB-values are coded on
  126.      other graphic-cards (they _should_ do it like the falcon, otherwise
  127.      the format would not be very device-independant, huh ?).
  128.      You can have multiple pictures at the same time each one having its
  129.      correct palette.
  130.      Hey, this is so great, if you don't have a FALCON, get one :-) !
  131.  
  132.  ii) 256-colour-mode:
  133.      This mode is used on resolutions with 8 planes, e.g. Falcon or TT-LOW.
  134.      The picture will be displayed without dithering.
  135.      Anyway, WATCH-IT never uses VDI-colours 0 to 15, since these colours
  136.      should be fixed for all applications. Instead, WATCH-IT shuffles around
  137.      the colours and substitutes similiar ones so that the VDI-colours don't
  138.      have to be used. 
  139.      Note that the palette can only be correct for the topped window, other
  140.      pictures may look quite strange. Simply top the window you wish to look at
  141.      and the correct palette is used.
  142.      By the way, pictures look a little bit like "widescreen" cinema on
  143.      TT-LOW. The reason is the strange pixel ratio on this resolution
  144.      (320 x 480). This may be fixed in future releases. 
  145.  
  146. iii) 16-colour-mode:
  147.      This mode is used on resolutions with 4 planes, e.g. TT-MID or ST-LOW.
  148.      It is the most time-consuming mode, since reducing 256 colours to 16
  149.      colours is not that easy. A special dither-algorithm is used (3 Floyd-
  150.      Steinberg-passes) so that all pictures can use the same palette, that
  151.      means you can have multiple windows which all look correct at the same
  152.      time). 
  153.      Pictures look best when viewed from some distance from the screen.
  154.      There are other possibilities to reduce the colours. An often used method
  155.      is to choose the 16 most used colours. This is definitely faster than
  156.      dithering, but in my opinion often has too poor results.
  157.      If you know better methods, please tell me !
  158.      Anyway, a 16 greyscale-mode will be included in future releases.
  159.  
  160.  iv) Monochrome-mode:
  161.      If none of the above modes can be used (e.g. on ST-HIGH, ST-MID or 
  162.      TT-HIGH), WATCH-IT will switch to monochrome-mode. 
  163.      The picture is dithered with Floyd-Steinberg error diffusion and 
  164.      displayed in VDI-colours 0 and 1. This normally means black and white,
  165.      but of course you can change this with the control panel (feel like 
  166.      Andy Warhol!) .
  167.        
  168.   
  169. 6. WATCH-IT and MultiTos 
  170. -------------------------
  171.  
  172. WATCH-IT runs under MultiTos, even though it can't handle it's own windows
  173. during depacking and dithering. This is so because depacker and plotter
  174. are written in highly optimized assembler and calling aes-functions
  175. during depack would slow down the whole thing significantly.
  176. However other applications can run during WATCH-IT does its work.
  177.  
  178. I consider writing a special MultiTos version which forks the depacker
  179. and ditherer so that they can run in the background while WATCH-IT-windows
  180. can still be moved.
  181. Any ideas about this (except from integrating the depacker into the
  182. event-loop which i definitely won't do !) are welcome !
  183.  
  184. Under MultiTos, no busy-bee is shown as this would be senseless in a
  185. multitasking environment.
  186.  
  187. The help and info-dialog are shown in windows, so dialog-boxes won't block
  188. the system.
  189.  
  190.  
  191. 7. Error messages
  192. ------------------
  193.  
  194. Out of AES-windows      : Close some windows and try again or get MultiTos
  195. Max. 32 windows allowed : This is the current limit.
  196. Read error in header,
  197.      palette or image   : The picture file is corrupted, you can try to
  198.                           load it anyway (press "Yes" in the "proceed ?" -
  199.                           alertbox), but the picture may look strange.
  200.  
  201.  
  202. 8. Disclaimer
  203. --------------
  204.  
  205. I really don't know how this program could harm you or your computer, but:
  206.  
  207. The author makes no warranties of quality or performance for this program.
  208. Use it at your own risk !
  209.  
  210.  
  211. 9. Feedback
  212. ------------
  213.  
  214. If you
  215. - have found bugs,
  216. - don't like the user interface,
  217. - can't get the program to work at all,
  218. - have good ideas how to improve this program,
  219. - or just want to say a few words concerning this program,
  220.  
  221. contact me via email:  sbock@informatik.uni-kl.de
  222.                        (this address will only be valid until end of
  223.                         september 1992)
  224. or in IRC (nickname : Robo).
  225.  
  226.  
  227.  
  228.  
  229.  
  230. Enjoy !
  231.